home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d22 / cm112.arc / CM.DOC next >
Text File  |  1989-01-28  |  57KB  |  1,036 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                   CopyMaster 1.12
  8.  
  9.                             Copyright 1988 by New-Ware
  10.  
  11.  
  12.                            (tm)  ┌─────────┐
  13.                            ┌─────┴───┐     │ MEMBER
  14.                         ───│         │     │────────────────
  15.                            │  ┌──────┴──┐  │ Association of
  16.                            │  │         ├──┘   Shareware
  17.                            └──┤    ■    │    Professionals
  18.                         ──────│    ║    │───────────────────
  19.                               └────╨────┘
  20.  
  21.      This program is produced by a member of the Association of
  22.      Shareware Professionals (ASP).  ASP wants to make sure that the
  23.      shareware principle works for you. If you are unable to resolve a
  24.      shareware-related problem with an ASP member by contacting the
  25.      member directly, ASP may be able to help. The ASP Ombudsman can
  26.      help you resolve a dispute or problem with an ASP member, but does
  27.      not provide technical support for members' products. Please write
  28.      to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a
  29.      Compuserve message via easyplex to ASP Ombudsman 70007,3536.
  30.  
  31.  
  32.                                REGISTRATION
  33.  
  34.           CopyMaster is sole property of New-Ware Shareware products.
  35.       The Shareware version may be freely copied and transferred to
  36.       individual parties for evaluation purposes.  It may be posted on
  37.       Bulletin Board systems (BBS) for electronic access as long as NO
  38.       FEE is charged for its distribution.  Computer information
  39.       services such as Compuserve (CIS), Genie, etc., are authorized to
  40.       post this product for subscriber access.  CopyMaster may NOT be
  41.       distributed on diskette by any disk distributor/vendor who
  42.       charges more than $5.00 for the diskette upon which the program
  43.       and attendant files are recorded.
  44.  
  45.           CopyMaster is a Shareware product.  Shareware is a computer
  46.       program distribution/marketing method that permits potential
  47.       buyers to thoroughly try the program prior to purchase.  It is
  48.       NOT free.  If, after evaluating the program, you find it to be
  49.       useful enough to use it on a regular basis, you are expected to
  50.       pay for it by registering with New-Ware.  The registration fee is
  51.       $30.00 and the registered version, which is NOT distributed as
  52.       Shareware, will not contain the opening Shareware screen nor the
  53.       closing messages.
  54.  
  55.           You may register CopyMaster in one of three ways:
  56.  
  57.                     1) By mail with check or money order to:
  58.  
  59.                               New-Ware
  60.                               6198 Agee Street #71
  61.                               San Diego, CA 92122
  62.  
  63.                     2) By telephone with Visa/Mastercard to:
  64.  
  65.                               New-Ware
  66.                               (619) 455-6225
  67.  
  68.                     3) Electronically through the New-Ware BBS:
  69.  
  70.                               (619) 455-5226
  71.  
  72.           The New-Ware Shareware products BBS operates 24 hours per
  73.           day, 7 days per week at 1200/2400 baud and N71 or N81.  Users
  74.           registering via the BBS receive access to the latest
  75.           registered version.  Users who register by mail or phone may
  76.           also access the registered version by BBS.  Just log on and
  77.           leave a comment to the sysop to the effect that you are a
  78.           registered user and desire access.
  79.  
  80.           This Shareware version of CopyMaster may be freely copied and
  81.           passed on to other individual users.  Disk
  82.           vendors/distributors that desire to distribute CopyMaster must
  83.           adhere to the guidlines presented in VENDOR.DOC.
  84.  
  85.           Press Ctrl-R from the main CopyMaster Display to display the
  86.           registration window.  Prompts will be issued for the pertinent
  87.           information and you will have the option of printing the
  88.           registration form when the form is completed.
  89.  
  90.           CALIFORNIA RESIDENTS MUST INCLUDE 7% STATE SALES TAX!
  91.  
  92.                I support my software.  One of the great strengths of the
  93.           Shareware concept is the interaction between the program author
  94.           and the users.  Many of the features contained in CopyMaster
  95.           are the result of user input.  If you have a problem evaluating
  96.           this program or desire to make a suggestion or comment (or even
  97.           a complaint), please do not hesitate to contact me.
  98.  
  99.  
  100.       VERSION HISTORY
  101.  
  102.           1.00 - First release.
  103.           1.01 - Minor bug fixes.
  104.           1.10 - Added capability to disk copy 1.2M and 1.4M disks.
  105.           1.11 - Added function to swap left and right windows (Ctrl-R).
  106.                  Added drop to DOS shell function (Ctrl-F1).
  107.           1.12 - Add toggle for operations with 800K disks formatted with
  108.                  FormatMaster.  Added deletion of tagged files.
  109.  
  110.       OPERATION OF COPYMASTER
  111.  
  112.       I.  Program Description.
  113.  
  114.                CopyMaster can be executed from any directory on any
  115.           disk drive.  It is initially configured for the left window
  116.           to display files in the directory from which it is executed
  117.           and for the right window to display files from the root
  118.           directory of the drive from which it is executed.  These
  119.           default settings may be changed.
  120.  
  121.                CopyMaster will simultaneously display files from two
  122.           directories in adjacent windows.  The directories that will
  123.           be shown can be set and saved as defaults from within the
  124.           program or can be entered on the command line as in the
  125.           following example:
  126.  
  127.                        cm c:\util d:\dbase
  128.  
  129.                The first DOS pathname determines the directory listing
  130.           in the LEFT (source) window and the second determines the
  131.           listing in the RIGHT (destination) window.  If just one path
  132.           name is entered as a parameter, CopyMaster will use it for
  133.           the listing in the RIGHT (destination) window.  This allows
  134.           specification of the destination directory from the command
  135.           line while CopyMaster uses its current default setting for
  136.           the LEFT (source) directory listing.  A file mask may be
  137.           included in either path name as in this example:
  138.  
  139.                        cm c:\util\*.exe d:\dbase\*.dbf
  140.  
  141.           If no mask is included, then CopyMaster will assume a mask
  142.           of "*.*".  If no drive designator is included, CopyMaster
  143.           will assume the current active drive.  If either path name
  144.           is invalid, CopyMaster will use the last saved default.
  145.  
  146.                CopyMaster is a full-featured file copy utility that
  147.           operates on IBM PC/XT/AT and compatible computers.  It makes
  148.           file and disk copying fast, easy, and effective through the
  149.           use of the following powerful features:
  150.  
  151.                       - Dual directory viewing of files
  152.                       - Batch tagging of files for copying
  153.                       - Move files across drives
  154.                       - Selectable date criteria for copying
  155.                       - Selectable file overwrite protection
  156.                       - CRC file copy verification
  157.                       - CRC disk copy verification
  158.                       - File encryption/decryption
  159.                       - Fast file search
  160.                       - Quick disk copying
  161.                       - Repeatable disk copying
  162.                       - Two-drive cyclic disk copying
  163.                       - Extensive error checking
  164.                       - File-by-file compare option
  165.                       - Disk Compare on 360K/720K/1.2M/1.4M
  166.                       - "Lotus" style command menu
  167.                       - Pop-up data-entry windows
  168.  
  169.           CopyMaster is written primarily in Turbo Pascal 5.0
  170.           supplemented with TurboPower Software's outstanding Turbo Pro
  171.           4.0 library package, which is HIGHLY recommended to all Turbo
  172.           Pascal programmers.  The program, as distributed, occupies
  173.           approximately 150K of normal ram and utilizes expanded memory
  174.           conforming to the LIM 3.2/4.0 Expanded Memory Specification
  175.           (EMS), if available in the host machine.
  176.  
  177.                CopyMaster will automatically adjust to monochrome or
  178.           color monitors.  If you are using a composite or "two color"
  179.           monitor similar to those used in laptop portables or are
  180.           using a mono monitor with a color card, place an "m" or "M"
  181.           or the command line when you execute the program, as follows:
  182.  
  183.                               CM m
  184.  
  185.                CopyMaster has also been designed to utilize the full
  186.           16 color text attribute capability of the Hercules InColor
  187.           Card.
  188.  
  189.                CopyMaster supports the use of a 2 or 3 button mouse.
  190.           The button actions for a 3 button mouse are:
  191.  
  192.                             L     =    PgUp
  193.                             R     =    PgDn
  194.                             M     =    Space bar (tag/untag)
  195.                             L+R   =    ENTER
  196.                             M+R   =    End
  197.                             M+L   =    Home
  198.                             M+L+R =    Alt-X (terminate)
  199.  
  200.           The button actions for a 2 button mouse are:
  201.  
  202.                             L     =    PgUp
  203.                             R     =    PgDn
  204.                             L+R   =    Space bar (tag/untag)
  205.  
  206.       II. CopyMaster Main Screen.
  207.  
  208.           This is the main screen:
  209.  
  210.                      CopyMaster 1.12 - Shareware Evaluation Copy
  211.                             Copyright 1988 by New-Ware
  212.    ╒═C:\CM\*.*═════════════════════════╕   ╒═C:\DEST\*.*═══════════════════════╕
  213.    │  ARCOPS   PAS 10/12/88   10,925*  │   │  ARCOPS   PAS 10/22/88   10,925*  │
  214.    │  ASPVAR   PAS 08/20/88    6,841*  │   │  CM       EXE 10/22/88   92,592*  │
  215.    │  BACKUP   BAT 10/23/88      118*  │   │  CM       PAS 10/22/88    2,862*  │
  216.    │  BINOBJ   EXE 08/24/88   11,088*  │   │  CONFIG   MNU 10/22/88      740*  │
  217.    │  CM       BAK 10/22/88    2,906*  │   │  CPUTYPE  OBJ 10/22/88      125*  │
  218.    │  CM       EXE 10/23/88   92,800*  │   │  CPYMASTR BAK 10/22/88    2,854*  │
  219.    │  CM       PAS 10/22/88    2,867*  │   │  CPYMASTR EXE 10/22/88   92,032*  │
  220.    │  CONFIG   MNU 10/19/88      740*  │   │                                   │
  221.    │  CPUTYPE  OBJ 01/20/88      125*  │   │                                   │
  222.    │  CPYMASTR BAK 10/20/88    2,854*  │   │                                   │
  223.    │  CPYMASTR EXE 10/22/88   92,032*  │   │                                   │
  224.    │  CRC      ASM 10/22/88    1,927*  │   │                                   │
  225.    │  CRC      BAK 10/22/88    4,277*  │   │                                   │
  226.    │  CRC      EXE 10/22/88    7,984*  │   │                                   │
  227.    │  CRC      OBJ 10/22/88    2,826*  │   │                                   │
  228.    ╘═════════════ Page 1 ══════════════╛   ╘═════════════ Page 1 ══════════════╛
  229.    Total Files  =        134               Total Files  =          7
  230.    Total Bytes  =  2,600,960               Total Bytes  =    210,944
  231.    Files Tagged =          0               Right drive  =          C:
  232.    Bytes Tagged =          0
  233.    Flex Tagged  =          0
  234.    Left drive   =          C:
  235.  
  236.           Note that there are two viewing windows, each dedicated to
  237.       displaying file information from separate directories.  The left
  238.       window ALWAYS displays the source directory for file copying and
  239.       the right window is ALWAYS displays the destination directory.
  240.       The active window is distinguished by a solid cursor bar.  The
  241.       user may switch from one window to the other with the TAB key or
  242.       the RIGHT and LEFT ARROW keys.  The PGUP, PGDN, HOME, END, and
  243.       UP/DOWN ARROW keys are available for moving the cursor bar
  244.       through the file list in the active window.  The top line of each
  245.       window shows the DOS path name and file mask currently in use for
  246.       that window.  Pertinent file copy related data appears at the
  247.       bottom of each window.  An asterisk ("*") next to a file name
  248.       indicates that the file has been created or changed since the
  249.       last backup.
  250.  
  251.           Using the TAB key to switch windows results in vertical bar
  252.       markers being used on each end of the file name in the inactive
  253.       window to mark the place where the cursor bar was positioned
  254.       when the switch occurred.  If the LEFT or RIGHT ARROW keys are
  255.       used to effect the switch, the cursor bar is left intact in the
  256.       inactive window.
  257.  
  258.           Pressing the INS key results in displaying files in the
  259.       right window that match files in the left window but that differ
  260.       in file size or file date/time.  These files are displayed in
  261.       the right window in high intensity on monochrome monitors and in
  262.       high intensity blue on color monitors.
  263.  
  264.           The file statistics for each directory are shown just
  265.       below each directory window.  As files are tagged, CopyMaster
  266.       keeps a running total of bytes tagged based not upon the sum
  267.       total of sizes of the files tagged, but on the space they
  268.       actually occupy on the default disk.  The minimum file size is
  269.       dependant upon the active drive's cluster size.  The cluster
  270.       size is always a multiple of the sector size.  For example, any
  271.       DOS formatted hard disk under 10 megabytes in size will use a
  272.       cluster size of 4096 (8 sectors).  A standard 360K floppy disk
  273.       will have a cluster size of 1024 bytes and a 3 1/2" 1.44M disk
  274.       has a cluster size of 512 bytes.  Total bytes and bytes tagged
  275.       values are based upon the active disk cluster size.  For
  276.       example, two 1-byte files on a disk with a cluster size of 2048
  277.       will occupy a total of 4096 bytes. The flex value is based upon
  278.       the cluster size of a 360K/720K disk, which is 1024 bytes.
  279.       Watching this value when tagging files for copying to a floppy
  280.       Disk will avoid trying to copy more files than the target disk
  281.       can contain.
  282.  
  283.           When CopyMaster first loads, it does some checking against
  284.       the default path names for the left and right windows.  If the
  285.       default left path name is invalid or contains no files or is the
  286.       root directory and contains no files and no directories,
  287.       CopyMaster will use the current directory to display files in the
  288.       left window.
  289.  
  290.           The contents of the left (source) and right (destination)
  291.       windows may be swapped by pressing Ctrl-R.  This action
  292.       reinitializes both windows so that the drive/directory/files
  293.       displayed in the right window are now displayed in the left
  294.       window and the drive/directory/files displayed in the left
  295.       window are now displayed in the right window.
  296.  
  297.       III. Main Command Menu.
  298.  
  299.           Pressing either slash key (backslash = \, or slash = /) will
  300.       display the main command menu as depicted below:
  301.  
  302.   ╒════════════════════════════ CopyMaster Commands ══════════════════════╕
  303.   │ Go Copy  Date  DKopy  Options  Backup  Reset  Eval  Sort Type  Config │
  304.   ╘═══════════════════════════════════════════════════════════════════════╛
  305.  
  306.       The cursor bar can be moved with the LEFT and RIGHT ARROW keys to
  307.       select the desired function or the function can be activated by
  308.       pressing the appropriate highlighted character.  CopyMaster can
  309.       be exited at any time by pressing ALT-X or CTRL-X.  The main menu
  310.       and all sub-menus may be exited by pressing the ESC key.  The
  311.       following is a brief summary of each main menu item:
  312.  
  313.               Go Copy   - Initiate copying of tagged files from
  314.                           the source directory to the destination
  315.                           directory.
  316.               Date      - Define date relations for selective copying.
  317.               DKopy     - Initiate copying of 360K/720 diskettes.
  318.               Options   - Set various program options.
  319.               Backup    - Copies only files with the archive bit set.
  320.               Reset     - Resets archive bits on all files in the
  321.                           active directory.
  322.               Sort Type - Selects one of five file name sorts.
  323.               Eval      - Disk compare operation.
  324.               Config    - Save current configuration to disk.
  325.  
  326.       Note that a help line for each menu item is displayed immediately
  327.       below the command menu.
  328.  
  329.       IV. Copying Tagged Files.
  330.  
  331.           Files are selected for copying by tagging them.  Files may be
  332.       tagged by pressing the SPACE BAR or the PLUS key with the cursor
  333.       bar over a file.  Pressing the SPACE BAR or the MINUS key will
  334.       untag a tagged file.  Tagged files are so indicated by a diamond
  335.       character to the left of the file name.  All files in the
  336.       directory may be tagged by pressing CTRL-T (or F6) and all tagged
  337.       files may be untagged by pressing CTRL-U (or F7).  Move through
  338.       the file list with the cursor pad keys or by pressing a CHARACTER
  339.       KEY, i.e., a key in the set "A" to "Z".  Pressing a CHARACTER KEY
  340.       will cause CopyMaster to seek the first file on the list that
  341.       starts with that character.  If it finds it, the cursor bar will
  342.       be moved to that file.  Alt-T will toggle between the normal
  343.       file viewing mode and a mode in which only tagged files are
  344.       displayed.
  345.  
  346.           Once a group of files has been tagged, pressing either SLASH
  347.       key and selecting GO COPY from the menu will cause the tagged
  348.       files to be copied from the source directory (left window) to the
  349.       destination directory (right window).  Files may not be tagged in
  350.       the right window.  During the copy process, the following
  351.       information window will appear:
  352.  
  353.                      ╒══════════ File Copy Window ═══════════╕
  354.                      │ Copied CM.BAK                         │
  355.                      │ Copied CM.EXE                         │
  356.                      │ Copied CM.PAS                         │
  357.                      │ Press any key to continue....         │
  358.                      │                                       │
  359.                      │                                       │
  360.                      │                                       │
  361.                      │                                       │
  362.                      │                                       │
  363.                      │                                       │
  364.                      │                                       │
  365.                      │                                       │
  366.                      │                                       │
  367.                      │                                       │
  368.                      │                                       │
  369.                      ╘═════════ Buffer Size = 16384 ═════════╛
  370.  
  371.       The copy operation will be terminated if any errors occur during
  372.       copying.  After performing a copy operation, ESC from the main
  373.       menu and press TAB or RIGHT/LEFT ARROW to refresh the destination
  374.       directory window.
  375.  
  376.           Files may be copied across disk drives by changing the
  377.       default drive in either window.  This is accomplished by pressing
  378.       CTRL-D (or F3) with the desired window active.  A window will
  379.       appear that prompts for the DOS drive designator.  If the drive
  380.       is valid and the drive is ready, the files in the current default
  381.       directory for the selected drive will be displayed.  If not, an
  382.       error message will appear.  The copy operation can be initiated
  383.       from the command menu.  If no files are tagged, the file
  384.       currently highlighted by the cursor bar will be copied.
  385.  
  386.           Files may be moved instead of copied.  Moving a file involves
  387.       placing the file into the destination directory and removing it
  388.       from the source directory.  In the case where both directories
  389.       are on the same drive, this is accomplished by simply renaming
  390.       the file if it does not exist in the destination directory.  If
  391.       it does, and overwrite protection is not active, the file will be
  392.       copied to the destination directory and then deleted from the
  393.       source directory.  If CRC verification is set to ON, then those
  394.       files that are actually copied will be verified.  Files moved
  395.       via the rename process are not subject to CRC verification.
  396.  
  397.           Either the source or the destination directory can be
  398.       changed.  Pressing CTRL-S (or F2) will toggles back and forth
  399.       between file display of the current directory and the display of
  400.       all directories on the active drive.  The first time this
  401.       function is used on a drive there will be a delay while
  402.       CopyMaster builds a list of directory names.  After that, the
  403.       toggle is instantaneous.  The cursor may be moved through the
  404.       list of directory names and a directory change can be effected by
  405.       pressing RETURN with the cursor bar highlighting the desired
  406.       directory.  If no files exist in a selected directory, a message
  407.       to that effect will appear.  Pressing a character key will move
  408.       the cursor to the first directory containing that character as
  409.       the first letter of the name, just as in the file viewing mode.
  410.  
  411.           CopyMaster will overwrite all files unless the Overwrite
  412.       confirmation toggle is set to ON.  This includes system, hidden,
  413.       and read-only files.  CopyMaster will, however, preserve the
  414.       file attribute of the overwritten file.  For example, suppose
  415.       you are copying MYDATA.DAT, which has a normal file attribute,
  416.       to a destination directory that contains a copy of MYDATA.DAT
  417.       that is marked hidden and read-only.  Unless the confirmation
  418.       toggle is ON, CopyMaster will overwrite MYDATA.DAT but it will
  419.       leave MYDATA.DAT with the original hidden/read-only attribute.
  420.       Remember, if you don't want to overwrite special files, either
  421.       use the confirmation option or configure CopyMaster not to
  422.       display these files.
  423.  
  424.       V. File Copying Options.
  425.  
  426.           CopyMaster offers a rich variety of file copying functions.
  427.       Files may be copied selectively by date, overwrite protection may
  428.       be invoked, and CRC (Cyclic Redundancy Check) verification may be
  429.       used.  Selecting DATE COPY from the main menu offers the
  430.       following options:
  431.  
  432.                              ╒═══ Date Copy ════╕
  433.                              │ A - Equal        │
  434.                              │ B - Before       │
  435.                              │ C - After        │
  436.                              │ D - On or Before │
  437.                              │ E - On or After  │
  438.                              │ F - Any Date But │
  439.                              │ G - Enter Date   │
  440.                              ╘══════════════════╛
  441.  
  442.           Each date relation on the menu is explained in a help line
  443.       that is displayed below the main menu.  For example, to copy only
  444.       those files with a date On or Before a specified date, select
  445.       item D.  The date may be specified by selecting item G to display
  446.       the following date entry window:
  447.  
  448.                     ╒═══════════ Time/Date Entry ═══════════╕
  449.                     │                                       │
  450.                     │ Enter the month (1..12):  10          │
  451.                     │                                       │
  452.                     │ Enter the day (1..31):    23          │
  453.                     │                                       │
  454.                     │ Enter the year (80..99):  88          │
  455.                     │                                       │
  456.                     │ Is 10/23/88 correct (Y/N)? [Y]        │
  457.                     ╘═══════════════════════════════════════╛
  458.  
  459.       Prompts are issued for entry of the month, day, and year and then
  460.       the resultant string is displayed for confirmation.  Pressing ESC
  461.       at any time will abort the data entry and leave the date string
  462.       as it was prior to entering this window.  Dates are only valid in
  463.       the DOS acceptable range of 01/01/80 and after.  Once a date is
  464.       specified, date based copying is made active through selection
  465.       from the OPTIONS menu.
  466.  
  467.                        ╒════════ Option Settings ═════════╕
  468.                        │ Retain File Date              OFF│
  469.                        │ Overwrite Confirmation        OFF│
  470.                        │ Date Range/Copy Date          OFF│
  471.                        │ Include Hidden Files          OFF│
  472.                        │ Set Archive Bits              OFF│
  473.                        │ Current File Mask             *.*│
  474.                        │ Move Files                    OFF│
  475.                        │ Beeps                          ON│
  476.                        │ CRC Verification              OFF│
  477.                        │ Freshen                       OFF│
  478.                        │ Quick Disk Copy               OFF│
  479.                        │ eXamine (COMP) files          OFF│
  480.                        │ Editor Name                  EDIT│
  481.                        │ PathName Defaults                │
  482.                        │ View System Memory               │
  483.                        │ 10 Sector Disk                   │
  484.                        ╘══════════════════════════════════╛
  485.  
  486.           The first option, Retain File Date, is an interesting one
  487.       that many will find useful.  When a file is copied by DOS, the
  488.       date of the new file is always the same as the source file.  With
  489.       CopyMaster you may elect to set the date of the new file to the
  490.       current system time/date.
  491.  
  492.           Overwrite protection is a feature that prevents CopyMaster
  493.       from overwriting a file of the same name in the destination
  494.       directory.  If this option is ON during a copy operation, a
  495.       prompt for overwrite confirmation is issued before the file is
  496.       copied or moved.
  497.  
  498.           The Date Range/Copy toggle determines whether or not
  499.       CopyMaster uses the date relation criteria for copying files.  If
  500.       this toggle is ON, the current date string will be be displayed.
  501.       The default, as distributed is 01/01/80.
  502.  
  503.                   ╒══════════ File Copy Window ═══════════╕
  504.                   │ Overwrite ACKERM.BAK?                 │
  505.                   │ Overwrite CM.BAK?                     │
  506.                   │ Copied CM.BAK                         │
  507.                   │ Overwrite CPYMASTR.BAK?               │
  508.                   │ Copied CRCFUNC.BAK                    │
  509.                   │ Press any key to continue....         │
  510.                   │                                       │
  511.                   │                                       │
  512.                   │                                       │
  513.                   │                                       │
  514.                   │                                       │
  515.                   │                                       │
  516.                   │                                       │
  517.                   ╘═════════ Buffer Size = 16384 ═════════╛
  518.  
  519.       The File Copy Window above shows that 4 files were tagged with the
  520.       Overwrite confirm toggle set to ON.  The first file was not
  521.       confirmed, the second file was confirmed, the third file was not
  522.       confirmed and the fourth file did not exist in the destination
  523.       directory and no confirmation was required.
  524.  
  525.           The Include Hidden Files toggle determines if hidden files in
  526.       a directory will be displayed.
  527.  
  528.           If the Set Archive Bits toggle is ON, then CopyMaster will
  529.       reset the Archive bit on each file that it copies.  This provides
  530.       a means for later copying only those files that have the archive
  531.       bit set.  The archive bit is set by DOS any time a file is
  532.       changed and written to disk.  It is an indicator that the file
  533.       has been created or changed since the last time the bit was
  534.       cleared.
  535.  
  536.           The DOS file mask determines which files will be displayed in
  537.       a window.  For example, if the file mask is set to "*.*" then all
  538.       files will be displayed.  If the mask is set to "*.WKS", then
  539.       only those files matching the mask will be displayed.  The mask
  540.       for either window may be set by using this option.  A window will
  541.       appear that prompts for entry of the new file mask.  This mask
  542.       will affect the window that was active when the main menu was
  543.       accessed.  The file mask can be set for each directory window.
  544.  
  545.                 ╒══════════════ File Mask Entry ══════════════╕
  546.                 │                                             │
  547.                 │ Edit file mask (ESC to abort): *.WKS        │
  548.                 │                                             │
  549.                 │ Mask is now *.WKS                           │
  550.                 │                                             │
  551.                 │ Accept it (Y/N)?  [Y]                       │
  552.                 │                                             │
  553.                 ╘═════════════════════════════════════════════╛
  554.  
  555.           The Move Files toggle will determine whether CopyMaster moves
  556.       or copies tagged files.  Moving a file entails either renaming
  557.       it so that it resides in the destination directory or, if the
  558.       file currently exists in the destination directory it will be
  559.       copied and then deleted from the source directory.
  560.  
  561.          Program beeps may be turned off entirely with the Beeps
  562.       toggle set to OFF.
  563.  
  564.           CRC (Cyclic Redundancy Check) Verification, when set to ON,
  565.       causes a sophisticated CRC algorithm to be applied to every byte
  566.       of the file as it passes through the file buffer.  When the
  567.       copying is complete, CopyMaster opens the new file, reads it back
  568.       through the buffer to calculate a second CRC value.  This value
  569.       is compared with the first and if the two are equal, the message
  570.       PASSED CRC will be displayed next to the file name in the File
  571.       Copy window.  If the check fails, the message CRC FAILED is
  572.       displayed.  Using the CRC verification approximately doubles the
  573.       time required to complete the copy, but ensures that the copy is
  574.       a verified exact copy of the source.
  575.  
  576.                  ╒══════════ File Copy Window ═══════════╕
  577.                  │ Overwrite CRC.BAK?                    │
  578.                  │ Copied CRC.BAK            PASSED CRC  │
  579.                  │ Overwrite CRCFUNC.BAK?                │
  580.                  │ Copied CRCFUNC.BAK        PASSED CRC  │
  581.                  │ Overwrite DECLARE.BAK?                │
  582.                  │ Copied DECLARE.BAK        PASSED CRC  │
  583.                  │ Overwrite DISKCOPY.BAK?               │
  584.                  │ Copied DISKCOPY.BAK       PASSED CRC  │
  585.                  │ Press any key to continue....         │
  586.                  │                                       │
  587.                  │                                       │
  588.                  │                                       │
  589.                  │                                       │
  590.                  │                                       │
  591.                  │                                       │
  592.                  ╘═════════ Buffer Size = 16384 ═════════╛
  593.  
  594.       Note that the results of the CRC check is reported for each file
  595.       copied when the CRC toggle is ON.  If a file fails the check,
  596.       the copying is terminated because that usually always means the
  597.       destination media is the problem.
  598.  
  599.            The Freshen option will copy files from the source to the
  600.       destination disk/directory only if the source file has a
  601.       date/time stamp that is newer than that of a file of the same
  602.       name residing in the destination directory.  Overwrite
  603.       protection, if enabled, will be in effect coincident with the
  604.       Freshen option.
  605.  
  606.            The eXamine option is a file-by-file compare function.
  607.       Note that this feature takes precedence and overrides any other
  608.       options that may be set.  It will compare each file in the
  609.       source (left window) directory with an existing file of the same
  610.       name in the destination (right window) directory.  This feature
  611.       uses the same CRC check algorithm used in file and disk copying
  612.       except that if the two files being compared are of a different
  613.       length, it will skip the reading of each file for a CRC check
  614.       and report that the compare FAILED.  If the files are compared
  615.       and they are exactly the same, COMPARED will be reported in the
  616.       Compare File Mode window.
  617.  
  618.            The PathName Default options permits setting CopyMaster to
  619.       show specified disk/directory combinations in the two file
  620.       viewing windows.  A valid DOS path name (without the file mask)
  621.       may be entered for either window.  Using the Config option will
  622.       save the entris to disk and thereafter CopyMaster will show the
  623.       two specified directories no matter from where it is executed.
  624.       If it is desired that the left window always show the files from
  625.       the directory in which it is executed, make a blank entry for
  626.       the left window when prompted.  Entering a blank line for the
  627.       right window default will cause the right window to always
  628.       display files from the root directory of the active drive.
  629.  
  630.            The 10 Sector Disk option is intended for use with those
  631.       systems that have problem with 10 sector formatting.  New-Ware's
  632.       FormatMaster will format a 360K disk to 800K in a 1.2M drive, but
  633.       some BIOS/DOS variants have problems dealing with a 360K diskette
  634.       formatted with 10 sectors/track and 80 tracks.  Toggling this
  635.       feature to ON will enable those systems to read/write from an 800K
  636.       disk.  When the toggle is set to ON, a window will appear that
  637.       permits the setting of the disk controller data rate.  The default
  638.       is set to 300 kilobits (Kb), which should suffice for most modern
  639.       AT/PS2 machines and clones.  If you have an old AT or clone or you
  640.       are copying to a 400K disk formatted with FormatMaster on an old
  641.       PC/XT or clone, you may need to set the data rate to 250Kb in
  642.       order to read/write to a floppy disk.
  643.  
  644.       VI.  Disk Copying.
  645.  
  646.           CopyMaster offers several unique and useful disk copying
  647.       features.  It will copy diskette (360K/1.2M/720K/1.4M) into a
  648.       buffer and then write the buffer back out to formatted disks.  If
  649.       desired, CRC verification can also be used with disk copying.
  650.       When copying the diskette, CopyMaster will first determine which
  651.       kind of buffer can be used to hold the entire contents of the
  652.       disk.  The first choice is to use normal RAM, if available.
  653.       Obviously, this won't be the case for a 720K disk.  If there is
  654.       insufficient RAM available but expanded memory (EMS) is installed
  655.       and enough is available, CopyMaster will utilize EMS for the
  656.       buffer.  If not, a virtual disk buffer will be used.  Note that
  657.       this will only work on a hard drive system where there is
  658.       sufficient disk space for buffering when copying 720K, 1.2M or
  659.       1.44M disks.
  660.  
  661.           An option that can be toggled from the Options menu is Quick
  662.       Copy.  Quick Copy should ONLY be used when the source diskette
  663.       has been prepared so that its files are stored in contiguous
  664.       sectors on the disk.  This can be accomplished by using
  665.       CopyMaster to copy files to a freshly formatted disk.  Copying
  666.       to a newly formatted disk insures that DOS will store the files
  667.       contiguously and there will be no fragmentation.  When Quick
  668.       Copy is in effect, CopyMaster copies only those clusters from the
  669.       source disk that are occupied by files.  This can reduce the
  670.       amount of time required to perform each disk copy.  For example,
  671.       suppose a 360K disk is prepared that contains contiguously stored
  672.       files that occupy 172 of the disk's 360 total clusters.  Quick
  673.       Copy will copy only those occupied clusters, thus reducing
  674.       read/write time.
  675.  
  676.           The Disk Copy control display offers several options.
  677.       Prompts are issued for the source drive and the target drive.
  678.       These can be the same drive and there will be a pause between
  679.       each write operation to allow for a disk change.  The target disk
  680.       is read into the buffer and then the copying process commences
  681.       and will continue until terminated by the user.  Disk copying may
  682.       be aborted at any time by pressing any key on the keyboard.
  683.  
  684.               ╒════════════════ Disk Copy Setup ════════════════╕
  685.               │                                                 │
  686.               │  Enter SOURCE drive letter: A                   │
  687.               │                                                 │
  688.               │  Enter TARGET drive letter: A                   │
  689.               │                                                 │
  690.               │  Do you desire two-drive copy (Y/N)?  [N] N     │
  691.               │                                                 │
  692.               │  Using NORMAL RAM to buffer disk data.          │
  693.               │                                                 │
  694.               │  ESC to abort, any other key to start copy      │
  695.               │                                                 │
  696.               │                                                 │
  697.               ╘═════════════════════════════════════════════════╛
  698.  
  699.           Cyclic, continuous, two-drive copying is also supported.
  700.       This feature allows selecting two drives as target drives and the
  701.       copying proceeds as before except that there is no pause between
  702.       drives.  The user is expected to change disks in one drive while
  703.       the other is busy copying.  With enough memory for a normal RAM
  704.       buffer and Quick Copy active, very rapid disk copying can be
  705.       effected.
  706.  
  707.          ╒════════════════════════ Disk Copy ════════════════════════╕
  708.          │                                                           │
  709.          │ Reading from disk in drive A                              │
  710.          │                                                           │
  711.          │ Using NORMAL RAM buffer to read 14 15K blocks.            │
  712.          │                                                           │
  713.          │ Reading block #14 - 215,040 bytes.                        │
  714.          │                                                           │
  715.          │ Disk sectors in memory - ready to copy (Y/N)? [Y]         │
  716.          │                                                           │
  717.          │                                                           │
  718.          ╘═══════════════════════════════════════════════════════════╛
  719.  
  720.          ╒════════════════════════ Disk Copy ════════════════════════╕
  721.          │                                                           │
  722.          │ Writing to disk in drive A                                │
  723.          │                                                           │
  724.          │ Using NORMAL RAM buffer to write 8 15K blocks.            │
  725.          │                                                           │
  726.          │ Writing block #8 -       0 bytes to go.                   │
  727.          │                                                           │
  728.          │ Copied 1 diskettes.                                       │
  729.          │                                                           │
  730.          │ Copy to another diskette (Y/N)?                           │
  731.          ╘═══════════════════════════════════════════════════════════╛
  732.  
  733.  
  734.       VII. Other Operations.
  735.  
  736.           Files may be be deleted by tagging and then pressing Alt-D.
  737.       The following window and prompt will then be presented:
  738.  
  739.                ╒════════════ Delete Tagged Files ════════════╕
  740.                │                                             │
  741.                │ Are you CERTAIN (Y/N)?  [Y]                 │
  742.                │                                             │
  743.                │                                             │
  744.                │                                             │
  745.                │                                             │
  746.                │                                             │
  747.                ╘═════════════════════════════════════════════╛
  748.  
  749.           Be CERTAIN you wish to delete the tagged files.  If Y is
  750.      pressed, all the tagged files that can be deleted will be deleted.
  751.      After the deleting, a message will appear that shows the number of
  752.      files tagged and the number of files actually deleted.  A
  753.      difference will occur if any of the tagged files cannot be deleted
  754.      because they are marked READ ONLY or HIDDEN.
  755.  
  756.           CopyMaster will load and pass a file name to a specified
  757.       editor.  Use the Editor Name option to enter the program file
  758.       name of the editor.  The .COM/.EXE extension is not required.
  759.       The editor file MUST be in a directory that is listed in the DOS
  760.       PATH string!!!  To edit a file, place the cursor bar over the
  761.       desired file name and press CTRL-E (or F10).
  762.  
  763.           Vern Buerg's justly famous LIST.COM may also be invoked from
  764.       CopyMaster.  Place the cursor bar over the file to LIST and press
  765.       CTRL-L or F9.  Again, LIST.COM MUST reside in a directory that
  766.       appears in the DOS PATH string.
  767.  
  768.           The directories which are viewed when CopyMaster is first
  769.       loaded may be changed with the Pathname Defaults option.  A
  770.       window will open and prompts will be issued to enter the pathname
  771.       for each window.  For example, suppose it is desired to view a
  772.       directory with a DOS path name of C:\WP\DOC in the left window
  773.       each time CopyMaster is initially loaded.  Enter C:\WP\DOC for
  774.       the left window path name.  Similarly, a default path name may be
  775.       specified for the right window.  These path names are saved to
  776.       disk along with all other option defaults from the Config
  777.       function.
  778.  
  779.           The last item on the Options Menu will bring up a window in
  780.       which certain information about the host system is displayed.
  781.  
  782.                  ╒════════ System Memory Summary ════════╕
  783.                  │                                       │
  784.                  │      Total RAM on board  = 640K       │
  785.                  │      System RAM in use   = 101K       │
  786.                  │      CopyMaster occupies = 148K       │
  787.                  │      RAM available       = 391K       │
  788.                  │      File copy buffer    = 32K        │
  789.                  │      RAM copy buffer     = 390K       │
  790.                  │      Floppy Disks        = 1          │
  791.                  │      Fixed Disks         = 2          │
  792.                  │      Disk space avail    = 3104K      │
  793.                  │      EMS memory avail    = 880K       │
  794.                  │      EMS version         = 4.1024     │
  795.                  │                                       │
  796.                  ╘═══════════════════════════════════════╛
  797.  
  798.       VIII.  Backup and Reset.
  799.  
  800.           The Backup and Reset functions work together to provide a
  801.       semi-automated method for backing up frequently updated files.
  802.       The Reset function clears the archive bit (bit 4 of the file
  803.       attribute byte) for each file.  DOS will reset this bit any time
  804.       the file is accessed and rewritten to disk.  If the archive bit
  805.       is set, then the file has been updated since the last time it was
  806.       cleared.  The backup function will copy all those files that have
  807.       had the archive bit reset.  If the Set Archive Bits option is ON,
  808.       CopyMaster will clear these bits as the files are copied.  An
  809.       effective regular file backup method can be established for any
  810.       directory.
  811.  
  812.       VIIII. Sort Type.
  813.  
  814.           CopyMaster offers five different ways to sort files for
  815.       displaying.  Files may be sorted by name, extension, date, and
  816.       size.  There are actually two sorts that operate using the file
  817.       extension.  The nested sort groups files by extension and then
  818.       sorts within each group by file name.  The name sort ignores the
  819.       extension and sorts by name only.  Whichever sort is selected at
  820.       the time the Config menu is used to save the defaults will become
  821.       the default at program run time.
  822.  
  823.                              ╒════ Sorts ════╕
  824.                              │ Unsorted      │
  825.                              │ By Name       │
  826.                              │ Nested        │
  827.                              │ Date          │
  828.                              │ Size          │
  829.                              │ Extension     │
  830.                              │ Order = UP    │
  831.                              ╘═══════════════╛
  832.  
  833.       X. File Search
  834.  
  835.           An extremely fast file search function is included in
  836.       CopyMaster.  This function will search all the directories on
  837.       the drive currently active in the left window for a specified
  838.       file.  If the directories of that disk have not been scanned and
  839.       read into memory, that will be accomplished before the actual
  840.       search is commenced.  A window will appear with a prompt to
  841.       enter the DOS file name.  DOS wild cards (* or ?) are
  842.       acceptable.  The first line in the window will contain a message
  843.       as to the status of the directory array in memory.  If the disk
  844.       hasn't been scanned to load the directory array into memory,
  845.       there will be a pause that is dependent upon the number of
  846.       directories that exist on the current drive.
  847.  
  848.           Enter the name of the file to search for and CopyMaster will
  849.       swiftly search all directories on the current disk for the file.
  850.       If it finds a match, it will pause and ask whether or not to
  851.       continue the search.  Any time the search is terminated after a
  852.       find, the search window will disappear and the cursor bar will
  853.       be highlighting the target file name.  Three things about the
  854.       search mode are important to note.  For maximum efficiencey, the
  855.       sort type is automatically changed to a file name sort.  If a DOS
  856.       wild card mask is used in the target file name, the search mask
  857.       for the left directory window will be changed to that mask.  And
  858.       thirdly, a search will pause at the first match found in any given
  859.       directory and will continue on to search the next directory if
  860.       not stopped.
  861.  
  862.       XI. Disk Compare.
  863.  
  864.           Copymaster will perform a disk comparison on the same drive
  865.       or on disks in two drives without needless swapping of disks.
  866.       The disk compare function supports all diskette formats.  A CRC
  867.       algorithm similar to the one employed in file and disk copying is
  868.       used in the comparison.  The source disk sectors are read in to a
  869.       buffer in blocks and a CRC value is computed for each block.
  870.       Then the target disk is similarly processed.  The two computed
  871.       CRC values for each block of each disk are then compare.  If even
  872.       1 bit of the target disk differs from that of the source disk,
  873.       the check will fail.  If a disk passes this test, you can be
  874.       certain that it is a mirror image of the source disk.  One
  875.       caution is in order.  It is possible to format two disks, copy
  876.       the same files in the same order to each disk and then have a CRC
  877.       comparison between them fail.  This is because some extraneous
  878.       bytes in the copy file buffer may be copied onto the disk at the
  879.       end of one or more of the files.  The disk compare function is
  880.       most useful after performing a series of disk copies.
  881.  
  882.               ╒═══════════════ Diskette Compare ════════════════╕
  883.               │                                                 │
  884.               │  Enter FIRST drive letter: A                    │
  885.               │                                                 │
  886.               │  Enter SECOND drive letter: A                   │
  887.               │                                                 │
  888.               │  Reading disk A - track #39                     │
  889.               │                                                 │
  890.               │  Place SECOND disk in drive A and hit a key.    │
  891.               │                                                 │
  892.               │                                                 │
  893.               │                                                 │
  894.               │  Detected a 360K disk.                          │
  895.               ╘═════════════════════════════════════════════════╛
  896.  
  897.       XII. File Encryption/DeCryption.
  898.  
  899.           CopyMaster will encrypt and decrypt any type of a file.  To
  900.       encrypt a file or files, press Ctrl-Z at the file viewing
  901.       display.  A window will appear to prompt you to enter your key.
  902.       The key you enter is like a password.  The encryption algorithm
  903.       uses the entered key as a basis for encrypting the file
  904.       contents.  The key may be up to 50 characters long and may
  905.       contain any character you can type from the keyboard.  The
  906.       longer the key string, the more secure the key is.  IMPORTANT!
  907.       DO NOT FORGET THE KEY THAT YOU ENTER OR YOU WILL NOT BE ABLE TO
  908.       DECRYPT THE ENCRYPTED FILE.  The key is only saved during the
  909.       time the CopyMaster is running.  Entry of an empty string will
  910.       turn encryption/decryption off.
  911.  
  912.           After entering a key, ALL FILES that are copied will be
  913.       encrypted.  This means that the files copied to the destination
  914.       directory (right window) will be encrypted and unreadable until
  915.       decrypted.  Encryption/decryption is turned off after each copy
  916.       operation.  A message will appear below the right window
  917.       whenever encryption is ON.  To decrypt files, change the left
  918.       window directory to the directory containing the encrypted files
  919.       and change the right window directory to where you wish to place
  920.       the decrypted files.  Press Ctrl-Z and enter the proper key.  IT
  921.       MUST BE THE SAME KEY AS THAT USED FOR ENCRYPTION!  Tag the
  922.       encrypted files and initiate the copy function.  The encrypted
  923.       files will be decrypted while being copied from the source (left
  924.       window) directory to the destination (right window) directory.
  925.  
  926.           The encryption algorithm employed is a sophisticated key
  927.       transposition technique that operates on the target file in 16
  928.       bit increments.  No claims are made regarding the degree of
  929.       security this method offers, but it would take an experienced
  930.       cryptologist a good deal of time and access to many encrypted
  931.       files to decipher the encryption routine.  Suffice it to say
  932.       that the contents of encrypted files are denied to everyone
  933.       except possibly a dedicated professional cyptography expert who
  934.       has access to your encrypted files.
  935.  
  936.           If you send encrypted files to someone else for use, be sure
  937.       the recipient has a copy of this version of CopyMaster and to
  938.       provide the proper key.  Subsequent versions of CopyMaster will
  939.       not change in regard to the encryption algorithm employed.
  940.  
  941.       XIII. Configuration.
  942.  
  943.           All current settings/toggles may be saved to disk by
  944.       selecting the Config item from the main command menu.  CM.EXE
  945.       MUST BE IN ONE OF THREE PLACES!  The CopyMaster program file must
  946.       either reside in the current directory, the root directory, or as
  947.       specified in the DOS environment.  Use the DOS SET command to
  948.       enter the following string into the environment (preferably
  949.       placed in the AUTOEXEC.BAT file):
  950.  
  951.                          CMLOC=PATHNAME
  952.  
  953.       Where PATHNAME is the DOS path name of the directory where CM.EXE
  954.       resides.  For example, suppose CM.EXE is located in a directory
  955.       named D:\UTIL\CM.  Place the following command in the
  956.       AUTOEXEC.BAT file to place the string in the environment each
  957.       time the machine is booted:
  958.  
  959.                          SET CMLOC=D:\UTIL\CM
  960.  
  961.       When attempting to save defaults to disk, CopyMaster will first
  962.       look in the current directory for CM.EXE.  If not found there, it
  963.       will look in the root directory of the active drive.  If not
  964.       found there, it will look in the environment for the string
  965.       mentioned above.  If not found there, the defaults will not be
  966.       saved.
  967.  
  968.           Two other default settings are available from the Config
  969.       menu.  CopyMaster uses 23 bytes of memory for each file record
  970.       stored in memory and 65 bytes for each directory name stored.  In
  971.       order to conserve memory and make as much RAM available for disk
  972.       copying, the maximum files and directory values may be configured
  973.       and saved.  The maximum value that can be entered for files is
  974.       999 and the maximum for directories is 200.  If you set the
  975.       default for files to a value that is less than the actual number
  976.       of files in a particular directory, CopyMaster will only display
  977.       up to the selected value and the remainder of the files will NOT
  978.       be displayed.  The same holds true for the directory maximum.
  979.  
  980.                        ╒═════ Configuration ═════╕
  981.                        │ File Limit          400 │
  982.                        │ Directory Limit      50 │
  983.                        │ Save to Disk            │
  984.                        ╘═════════════════════════╛
  985.  
  986.       XIV. Function Keys.
  987.  
  988.           Ten CopyMaster commands may be activated without going
  989.       through the main command window.  Each of these is activated
  990.       either by a control key combination (e.g., Ctrl-E) or a function
  991.       key.  Here are the control and function key assignments:
  992.  
  993.               ╒═════════════ Command Keys ═════════════╕
  994.               │                                        │
  995.               │ Key         Function          Ctrl Key │
  996.               │ F1  -  Help                   (Ctrl-H) │
  997.               │ F2  -  Show directories       (Ctrl-S) │
  998.               │ F3  -  Change active drive    (Ctrl-D) │
  999.               │ F4  -  Commence normal copy   (Ctrl-G) │
  1000.               │ F5  -  Commence disk copy     (Ctrl-C) │
  1001.               │ F6  -  Tag all files          (Ctrl-T) │
  1002.               │ F7  -  Untag all files        (Ctrl-U) │
  1003.               │ F8  -  Search disk for a file  (Alt-S) │
  1004.               │ F9  -  Call LIST.COM          (Ctrl-L) │
  1005.               │ F0  -  Call favorite EDITOR   (Ctrl-E) │
  1006.               │ Tab -  Switch viewing windows          │
  1007.               │ Space bar - alternate tag/untag (+  -) │
  1008.               │ Ctrl-Z    - Encrypt/Decrypt files      │
  1009.               │ \ or /    - Activate command bar menu  │
  1010.               │ INS       - Highlight matching files   │
  1011.               │ <RET>     - View file date/time & attr │
  1012.               │ Ctrl-R    - Switch Left/Right Windows  │
  1013.               │ Ctrl-F1   - Shell to DOS level         │
  1014.               │  Alt-D    - Delete tagged files        │
  1015.               ╘════════════════════════════════════════╛
  1016.  
  1017.       Pressing Ctrl-K  when not in the command menu structure will
  1018.       display a window that displays these key assignments.
  1019.  
  1020.       XV. Miscellaneous.
  1021.  
  1022.           Cyclic functions like batch copying, disk copying, etc. may
  1023.       terminated at any time by pressing any key on the keyboard.
  1024.  
  1025.           Many of the features contained in CopyMaster are the result
  1026.       user input.  Comments, suggestions, and even complaints are awlays
  1027.       welcome.
  1028.  
  1029.  
  1030.       Thank you very much for evaluating CopyMaster.
  1031.  
  1032.  
  1033.       John Newlin
  1034.       New-Ware
  1035.  
  1036.